📘 ConstructQ · Task Management

1. ภาพรวม (Overview)

เอกสารนี้เป็น คู่มืออธิบายการทำงาน ของหน้าจอจัดการ Task (QC + NCR) ในระบบ ConstructQ สำหรับทีมพัฒนาซอฟต์แวร์ ครอบคลุมตั้งแต่ เริ่มสร้าง Task จนปิด Task ผ่านทุกสถานะใน Workflow Lifecycle และอธิบายบทบาทของผู้ใช้แต่ละคนที่ต้องดำเนินการในแต่ละขั้นตอน

1.1 บทบาทที่เกี่ยวข้อง (4 roles หลัก)

2. Workflow Lifecycle (7 สถานะหลัก + 2 NCR)

2.1 สถานะของ Task

2.2 State Diagram (Happy path + Rework path)

                                        ┌────────────────────────────────────────────┐
                                        │                                            ▼
[created] ──assign──▶ [assigned] ──receive──▶ [in_progress] ──submit──▶ [review] ──approve──▶ [done] 🎉
                                                    │                        │
                                                    │                        └──reject──▶ [rejected] ──rework──┐
                                                    │                                                          │
                                                    │                              ┌───────────────────────────┘
                                                    │                              ▼
                                                    │                        (back to in_progress)
                                                    ▼
                                              [blocked] ─unblock──▶ (back to previous state)

  ตรวจพบข้อบกพร่อง (fail) ระหว่างตรวจ Checklist:
  [in_progress] ──fail(item)──▶ [ncr_open] ──Sub แก้ไข──▶ [ncr_verify] ──Inspector ตรวจซ้ำ──▶ กลับ [in_progress]

3. เส้นทางการทำงานตั้งแต่สร้าง Task ถึงปิด Task

4. Web App — บทบาท Project Manager (PM)

4.1 ขั้นตอนการสร้าง Task Bulk (PM ทำบ่อย)

1. เข้าหน้า Task Management → กด "📋 สร้าง Task แบบ Bulk"
2. ระบบแสดง WBS ของโครงการเป็น hierarchical tree (L1 → L2 → L3)
3. PM เลือก L3 activities ที่ต้องการสร้าง (checkbox หลายแถว)
4. ระบุ Defaults ที่ apply กับทุก Task ที่เลือก · เรียงตาม TmCreate ใหม่:
   1. Zone · Priority · Start-Due date range (v38.0)
   2. Checklist · Workflow
   3. Inspector · Approver
5. Ref Std แสดงเป็น chip ตาม WBS default (ไม่แก้ไข ตาม v37.0)
6. กด "🚀 สร้าง N Tasks" → ระบบสร้างทั้งหมดในสถานะ created

5. Web App — บทบาท QC Manager (QCM)

5.1 ขั้นตอน Review Task (QCM ทำเมื่อ state = review)

1. รับ notification ว่ามี Task รอตรวจทาน
2. เข้า Task Management → filter state = review
3. คลิกการ์ด → หน้า Task Detail
4. ตรวจ Overview tab: pass/NCR/rate · description · assignees
5. ตรวจ Checklist tab: ทุกข้อ pass · comments · photos · signature
6. ตรวจ NCR tab: ถ้ามี NCR ต้องปิดครบก่อนอนุมัติ
7. ตรวจ Audit tab: ตรวจ trace ทุกการเปลี่ยนแปลง (compliance)
8. ตัดสินใจ:
   • อนุมัติ: กด "✓ อนุมัติ" → state → done → PM ได้รับ notification
   • ตีกลับ: กด "↩ ตีกลับ" → ระบุเหตุผล → state → rejected → Inspector ทำรอบใหม่

6. Mobile App — บทบาท QC Inspector

6.1 หน้าจอสำคัญ (Mobile App v23.0)

6.2 Flow ตรวจ Checklist หน้างาน (ตาม v23.0)

1. รับ notification → เปิดแอป → แตะ Task card ที่มีสถานะ assigned
2. Task Detail → Tab Overview → กด "📋 เริ่มตรวจ Checklist" → state → in_progress
3. ระบบทำ GPS check-in อัตโนมัติ · Banner สีเหลืองแสดง location
4. Tab strip ด้านบน · แต่ละหมวด (A/B/C…) แสดง N/M answered · แตะสลับหมวด
5. Circle stepper · วงกลม 30px · เลขข้อ · ✓ เหลืองมุมขวาบนเมื่อตอบแล้ว · pin ตลอดการนำทาง
6. สำหรับแต่ละข้อ:
   • ก่อนตอบ: ดู Rule chip 📏 (เกณฑ์ + severity + Auto-NCR/warn)
   • ตอบ widget ตาม type: passfail 2 ปุ่ม / number + unit / radio / checkbox / date / signature / photo / color / text / longtext
   • แนบรูป + comment (บังคับทุกข้อ)
   • ถ้า passfail และกด "✗ ไม่ผ่าน" → Confirm dialog "ยืนยันสร้าง NCR?" → confirm → NCR ถูกสร้าง
7. Navigation: ปุ่ม ‹ ก่อนหน้า / ถัดไป › ล่างสุด · ข้อสุดท้ายของหมวด → ข้ามหมวดถัดไปอัตโนมัติ
8. Completion screen: เมื่อตอบครบ → หน้าสรุป pass/fail/skip พร้อมปุ่ม "✓ ส่งผล + เซ็นรับรอง"
9. กดส่ง → state → review · toast "ส่งให้ QC Manager แล้ว"

6.3 Flow ตรวจซ้ำ NCR (verify)

1. รับ notification NCR verify
2. เปิด Task ที่ state = ncr_verify
3. ดู NCR tab → ดูรูป Before/After ที่ Sub ส่งมา
4. ไปหน้างาน → ตรวจว่าแก้ตามที่บันทึกหรือไม่
5. ถ้าผ่าน: กด "ปิด NCR" → NCR status → closed
6. ถ้ายังไม่ผ่าน: กด "ส่งกลับให้แก้ใหม่" → NCR status → open (loop กลับ Sub)

7. Mobile App — บทบาท Sub Contractor

7.1 Flow แก้ไข NCR (ตัวอย่าง Paint NCR)

1. Sub เปิดแอป → NCR list → NCR-2026-0054 · status ncr_open
2. ดู 5 ขั้นตอนแก้ไขของ Inspector
3. ทำตามขั้นตอนที่หน้างาน · ถ่ายรูปทุกขั้น
4. แนบรูป After ≥ 2 มุม
5. กรอกหมายเหตุการแก้ไขที่ทำ
6. กด "ส่งกลับให้ตรวจซ้ำ" → NCR status → ncr_verify
7. รอ Inspector ตรวจซ้ำ

8. Audit Trail (บันทึกทุกการกระทำ)

ทุก action ในระบบถูกบันทึกใน task_audit_log ตามมาตรฐานงานก่อสร้างไทย · เก็บ:

• ts: timestamp precision microsecond
• actor_name / actor_id: ใครทำ (System สำหรับ automation)
• role: QCM / QC / Engineer / PM / System
• action: task.created · task.assigned · task.received · state.changed · workflow.linked · inspection.submitted · inspection.rejected · notification.sent
• detail: ข้อความอธิบาย
• ip: IP ที่ทำ (NULL สำหรับ System)

8.1 ตัวอย่าง Audit log ของ Task TQ-2026-054

9. สรุป Role × Platform × State Matrix

10. สรุปสำหรับทีมพัฒนา